home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
MrmFetchWidget.z
/
MrmFetchWidget
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX))))
NNNNAAAAMMMMEEEE
MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt - Fetches and creates an indexed (UIL named)
application widget and its children
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Mrm/MrmPublic.h>
CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt(
MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
SSSSttttrrrriiiinnnngggg iiiinnnnddddeeeexxxx,
WWWWiiiiddddggggeeeetttt ppppaaaarrrreeeennnntttt____wwwwiiiiddddggggeeeetttt,
WWWWiiiiddddggggeeeetttt ****wwwwiiiiddddggggeeeetttt,
MMMMrrrrmmmmTTTTyyyyppppeeee ****ccccllllaaaassssssss);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttfunction fetches and creates an indexed
application widget and its children. The indexed
application widget is any widget that is named in UIL. In
fetch operations, the fetched widget's subtree is also
fetched and created. This widget must not appear as the
child of a widget within its own subtree. MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt
does not execute XXXXttttMMMMaaaannnnaaaaggggeeeeCCCChhhhiiiillllddddfor the newly created widget.
All widgets fetched by a call to MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt are not
managed at the time of their creation callbacks.
_h_i_e_r_a_r_c_h_y__i_d
Specifies the ID of the _U_I_D hierarchy that
contains the interface definition. The value of
_h_i_e_r_a_r_c_h_y__i_d was returned in a previous call to
MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
_i_n_d_e_x Specifies the UIL name of the widget to fetch.
_p_a_r_e_n_t__w_i_d_g_e_t
Specifies the parent widget ID.
_w_i_d_g_e_t Returns the widget ID of the created widget.
_c_l_a_s_s This argument must be set to an actual pointer; it
cannot be a NULL pointer. MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt sets this
argument to an implementation dependent value.
An application can fetch any named widget in the _U_I_D
hierarchy using MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt. MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttcan be called
at any time to fetch a widget that was not fetched at
application startup. MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttcan be used to defer
fetching pop-up widgets until they are first referenced
(presumably in a callback), and then used to fetch them
once.
Page 1 (printed 10/24/98)
MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt((((3333XXXX))))
MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttcan also create multiple instances of a widget
(and its subtree). In this case, the _U_I_D definition
functions as a template; a widget definition can be fetched
any number of times. An application can use this template
to make multiple instances of a widget, for example, in a
dialog box box or menu.
The index (UIL name) that identifies the widget must be
known to the application.
RRRREEEETTTTUUUURRRRNNNN
This function returns one of the following status return
constants:
MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
The function executed successfully.
MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
The hierarchy ID was invalid.
MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD
The widget was not found in UID hierarchy.
MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
The function failed.
RRRREEEELLLLAAAATTTTEEEEDDDD
MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy(3), MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee(3).
Page 2 (printed 10/24/98)